Previous Book Contents Book Index Next

Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /
Chapter 16 - Storage Objects / Storage Objects Reference
Storage Objects Routines / Creating and Accessing Handle Storage Objects


Q3HandleStorage_Get

You can use the Q3HandleStorage_Get function to get information about a handle storage object.

TQ3Status Q3HandleStorage_Get (
TQ3StorageObject storage, 
Handle *handle, 
unsigned long *validSize);
storage
A handle storage object.
handle
On entry, a pointer to a handle. On exit, a pointer to a handle to the block of memory associated with the specified storage object.
validSize
On exit, the size, in bytes, of the block of memory whose address is returned through the buffer parameter.
DESCRIPTION
The Q3HandleStorage_Get function returns, in the handle and validSize parameters, the handle and size of the block of memory currently associated with the handle storage object specified by the storage parameter. Note that the returned handle is a handle to the storage object's data, not of a copy of that data.

ERRORS
kQ3ErrorInvalidObjectParameter
kQ3ErrorNULLParameter


Previous Book Contents Book Index Next

© Apple Computer, Inc.
11 JUL 1996